The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
pgconsole	Ready	Preview, Comment	Jun 26, 2026 7:15am

Preview deployment for your docs. Learn more about Mintlify Previews.

💡 Tip: Enable Workflows to automatically generate PRs for you.

Greptile Summary

This PR ensures every audit event carries an explicit source value — "web" for browser-originated login, logout, SQL, and export events, and the existing "mcp" for MCP-path SQL — eliminating the blank-source case for non-MCP events. It also wires source into the ActionCell badge so the System tab now surfaces the origin just like the Connection tab.

• server/lib/audit.ts: source is promoted from an optional 'mcp'-only field on SQLExecuteEvent to a required 'web' | 'mcp' field across all four event types; auditSQL defaults to 'web' via opts?.source ?? 'web', preserving the MCP opt-in path.
• src/pages/AuditLog.tsx: Single-line change passes entry.source to ActionCell in the System tab (Connection tab was already wired).
• tests/audit.test.ts / docs/features/audit-log.mdx: New tests cover web, MCP, and auth-event source values; docs updated to show source in all four event examples and field tables.

Confidence Score: 5/5

Safe to merge — the change is additive, all callers are updated, the proto already carried the source field, and the server mapper already handled it.

The core logic is straightforward: a required field replaces an optional one, every emitter is updated, and the opts?.source ?? 'web' default correctly preserves the MCP path. The proto definition (field 12) and the toAuditLogEntry mapper were already in place, so no wire-format or API changes are needed. The only findings are cosmetic — redundant type guards in tests and a missing field table in the logout docs section.

No files require special attention; tests/audit.test.ts has minor style cleanup and docs/features/audit-log.mdx is missing a field table for the auth.logout section.

Important Files Changed

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[User Browser] -->|login/logout/SQL/export| B[Web Handler]
    C[MCP Client] -->|SQL via MCP tool| D[MCP Handler]

    B -->|auditLogin / auditLogout| E["source: 'web'"]
    B -->|auditSQL no opts| E
    B -->|auditExport| E
    D -->|auditSQL opts.source='mcp'| F["source: 'mcp'"]

    E --> G[AuditEvent store]
    F --> G

    G -->|listAuditEvents| H[Connection tab]
    G -->|listSystemAuditEvents| I[System tab]

    H --> J["ActionCell + source badge"]
    I --> J

%%{init: {'theme': 'base', 'themeVariables': {"darkMode": true, "background": "#0d1117", "primaryColor": "#21262d", "primaryTextColor": "#e6edf3", "primaryBorderColor": "#8b949e", "lineColor": "#8b949e", "textColor": "#e6edf3", "edgeLabelBackground": "#161b22", "actorBkg": "#21262d", "actorBorder": "#8b949e", "actorTextColor": "#e6edf3", "actorLineColor": "#8b949e", "signalColor": "#8b949e", "signalTextColor": "#e6edf3", "noteBkgColor": "#373320", "noteBorderColor": "#d4a72c", "noteTextColor": "#f0e6c0", "labelBoxBkgColor": "#21262d", "labelBoxBorderColor": "#8b949e", "labelTextColor": "#e6edf3", "loopTextColor": "#e6edf3", "activationBkgColor": "#30363d", "activationBorderColor": "#8b949e"}}}%%
flowchart TD
    A[User Browser] -->|login/logout/SQL/export| B[Web Handler]
    C[MCP Client] -->|SQL via MCP tool| D[MCP Handler]

    B -->|auditLogin / auditLogout| E["source: 'web'"]
    B -->|auditSQL no opts| E
    B -->|auditExport| E
    D -->|auditSQL opts.source='mcp'| F["source: 'mcp'"]

    E --> G[AuditEvent store]
    F --> G

    G -->|listAuditEvents| H[Connection tab]
    G -->|listSystemAuditEvents| I[System tab]

    H --> J["ActionCell + source badge"]
    I --> J

_{Reviews (1): Last reviewed commit: "fix: always tag audit event source" | Re-trigger Greptile}